home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / applets / collectn / predicat.jav < prev    next >
Text File  |  1995-10-14  |  1KB  |  51 lines
  1. /*
  2.   File: Predicate.java
  3.  
  4.   Originally written by Doug Lea and released into the public domain. 
  5.   Thanks for the assistance and support of Sun Microsystems Labs, Agorics 
  6.   Inc, Loral, and everyone contributing, testing, and using this code.
  7.  
  8.   History:
  9.   Date     Who                What
  10.   24Sep95  dl@cs.oswego.edu   Create from collections.java  working file
  11.  
  12. */
  13.   
  14. package collections;
  15.  
  16. import java.util.Enumeration;
  17. import java.util.NoSuchElementException;
  18.  
  19. /**
  20.  *
  21.  *
  22.  * Predicate is an interface for any class supporting a
  23.  * predicate(Object obj) method that returns true or false
  24.  * depending on whether obj obeys the maintained predicate.
  25.  * <P>
  26.  * When used as an element screener, check should 
  27.  * return false if the
  28.  * element should not be allowed in the collection, in which case
  29.  * any attempted add or replace operation will raise an exception. Use of
  30.  * screened collections is a simple way to dynamically ensure
  31.  * that all elements have some desired property.
  32.  * @author Doug Lea
  33.  * @version 0.93
  34.  *
  35.  * <P> For an introduction to this package see <A HREF="index.html"> Overview </A>.
  36. **/
  37.  
  38.  
  39. public interface Predicate {
  40.  
  41. /**
  42.  * Report whether obj obeys maintained predicate
  43.  * @param obj any object (possibly null)
  44.  * @return true is obeys predicate
  45. **/
  46.  
  47.   public boolean     predicate(Object obj); 
  48. }
  49.  
  50.  
  51.